home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / shells / mintbash.zoo / readme.st
Text File  |  1991-06-08  |  3KB  |  59 lines
  1. THIS PROGRAM REQUIRES THAT MiNT BE ACTIVE IN ORDER TO RUN.
  2. If you try to run it without MiNT, you will get funny error messages
  3. every time you try to run a program. Also note that it requires version 0.6
  4. or higher of MiNT.
  5.  
  6. This is a port of bash, the GNU Bourne Again shell, to MiNT. It's essentially
  7. equivalent to the BSD version, right down to the (useless, on the ST) check
  8. for new mail. This means, in particular, that the backslash character ('\')
  9. is special, and must be duplicated to be passed to a program, i.e. type
  10. 'ls c:\\bin' instead of 'ls c:\bin'. For this reason, it's best used with
  11. utilities that allow forward slashes to separate directories.
  12.  
  13. The following ST specific features should be noted:
  14. (1) Searches for executable programs always consider the current directory
  15. first; this is a bug that I introduced in order to provide feature (2) easily.
  16. (2) Executable files with the "usual" extensions need not have those extensions
  17. added, i.e. if you type 'ls' then bash will look for 'ls', 'ls.ttp', 'ls.prg',
  18. and 'ls.tos' in that order in each directory on your path.
  19. (3) The ".bashrc" file is called "bash.rc" on the ST. Similarly, the .profile
  20. file is called "profile", the ".bash_profile" file is called "bash_pro",
  21. the ".bash_login" file is called "bash_log", and the ".bash_history" file
  22. is called "bash_his".
  23. (4) Only some of the "ulimit" options are supported under MiNT, namely
  24. the -d (malloc'd memory limit), -m (total memory limit), and -t (cpu
  25. time limit) options; note also that -d and -m mean slightly different
  26. things under MiNT than they do under BSD.
  27. (5) There's a bug (?) in the job control feature such that if you run
  28. bash from a program that doesn't know about job control, that program
  29. will be suspended when bash exits. Use "fg" (or whatever) to start
  30. the program again, or else never leave bash (half :-); I'm sure bash
  31. could be used as a replacement for the MiNT init.prg).
  32.  
  33. If you don't know bash already... sorry, but there isn't much in the way
  34. of docs. Get the source code (see below), and/or a good book on the Unix
  35. /bin/sh. There is (some) online help; just enter "help" on a line by
  36. itself. See also the "features" file.
  37.  
  38. The source code is available from the usual GNU places (prep.ai.mit.edu
  39. being the "canonical" place). I used bash 1.05 taken from my local Sun
  40. network; it already had some diffs on it (probably most of the known bug
  41. fixes), and I used Eric Smith's original diffs as a starting point.
  42. The diffs included in this distribution are from the patched Sun version,
  43. so you will NOT need Eric's diffs to re-build this. I re-wrote the Makefile
  44. virtually from scratch; it's not terribly complete, but it does mean that
  45. the whole process is totally automatic. It was compiled under the MiNT-gcc
  46. library version 0.8; getting it to work with another compiler/library
  47. setup will probably prove impossible. Note also that I have the
  48. readline/history library installed as a standard library on my machine.
  49.  
  50. I will attempt to support this, but I don't have much time to do so, and
  51. I intend abandoning 1.05 and porting 1.07 or higher later this year (91).
  52.  
  53. Happy bashing!
  54.  
  55. 'Grave' Dave Gymer | Note that I don't have access to the net during
  56.  dpg@Cs.Nott.AC.UK | vacations, so don't be surprised if you get an
  57.                    | automatic message or no response from July to early
  58.                    | October. Sorry for any inconvenience.
  59.